Custom canonical ul without html extension #1696
Conversation
|
I'm confused about why this PR doesn't have a preview URL for us to check? |
Not sure neither. I got the link from the Checks earlier but is now missing as well. I added preview url in the PR description under Demo. https://b0372b27.devportal.pages.dev/ |
|
I can see where we are going with this but the html_baseurl configuration is used by the sitemap, which now doesn't show URLs. I think we should try not to break the sitemap when fixing the canonical URLs. |
You are right - checking from the sitemap the links still have I am not aware where else in the sphinx build uses html_baseurl, as the documentation only mentioned -> It is used to indicate the location of document using The Canonical Link Relation. Do you have other suggestion to tackle this issue? |
|
Not a good solution since removing |
What changed, and why it matters
In all pages, the canonical tags of docs.aiven.io are pointing to redirected URL versions ending with .html. For example, https://docs.aiven.io/docs/tools/api has a canonical to https://docs.aiven.io/docs/tools/api.html. This creates a redirect-canonical loop and makes the pages non-indexable. The canonical tags need to be the version without .html. So the canonical in the example should be https://docs.aiven.io/docs/tools/api
Resolving this issue
Solution
Instead of using default html_baseurl, set custom canonical tag in base template to have control of the
pagename.Demo
https://b0372b27.devportal.pages.dev/docs/tools/api
